home *** CD-ROM | disk | FTP | other *** search
/ Kids Coloring Wonderland / Kids Coloring Wonderland.iso / fun / music_pb / mpb.doc < prev    next >
Text File  |  1992-09-13  |  13KB  |  327 lines
  1.  
  2.                              The
  3.                      MUSICAL PAINT BRUSH
  4.                    Version 1.0 Sept. 1992
  5.               (c) Copyright 1992 Ludicrous Data
  6.               1004 Marticville Rd.  Pequea, PA
  7.                        (717) 284-3736
  8.  
  9.  
  10.      Welcome to the MUSICAL PAINT BRUSH, the paint program
  11. that is guaranteed to bring hours of enjoyment to young
  12. people everywhere. The feature that sets the MUSICAL PAINT
  13. BRUSH apart from many similar packages is, of course, the
  14. music and sounds that abound to bring your creations to
  15. life, and to amuse you while you create.
  16.  
  17.      The MUSICAL PAINT BRUSH is NOT free software. In order
  18. to keep prices at a minimum this  program is being
  19. distributed as SHAREWARE. What this means, if you are not
  20. already familiar with the term, is that you may use this
  21. program on a trial basis without paying for it, however, if
  22. you continue to use this program after the trial period has
  23. elapsed you must register it with the author and pay to
  24. purchase your copy of the software.
  25.  
  26.      The free trial period allowed with the MUSICAL PAINT
  27. BRUSH is 30 days. This should be ample time for you to
  28. decide if this program is worth purchasing. If you decide
  29. that it is (and hopefully you will)  please complete the
  30. registration form found in the text file REGISTER.DOC and
  31. send with the registration fee of $25 to:
  32.  
  33.  
  34.           David Reinhart
  35.           Ludicrous Data
  36.           1004 Marticville Rd.
  37.           Pequea, PA 17565
  38.  
  39.  
  40.      Registrants of this software will receive free the next
  41. major upgrade of the package, should there be one. I make no
  42. guarantees that an upgrade will be made available, nor at
  43. what date an upgrade will be made available. Any
  44. suggestions/improvements that you might submit to me will be
  45. thoughtfully considered, and may become part of an upgrade
  46. package.
  47.  
  48.  
  49.  
  50. Requirements:
  51.      VGA monitor and video card capable of 640x480 16 color graphics
  52.      Microsoft or compatible mouse
  53.  
  54.  
  55. Files included in this package:
  56.      MPB.EXE        the MUSICAL PAINT BRUSH program
  57.      SHOW.EXE       a program to display files created with the MPB
  58.      *.BTN, *.ICN   support files needed by  PAINT.EXE
  59.      MPB.DOC        this document
  60.      REGISTER.DOC   MUSICAL PAINT BRUSH registration form
  61.  
  62.  
  63.  
  64.                         FEATURES
  65.  
  66.      The MUSICAL PAINT BRUSH is a delight to young people of
  67. all ages because of the many sounds and songs available
  68. within the program. Each of the drawing tools has it's own
  69. unique sound that it produces while editing an image.  The
  70. many sound "buttons" can be used at any time to add impact
  71. to an otherwise lifeless drawing. Also there are an
  72. assortment of songs that can be played while editing an
  73. image to keep the young mind amused.
  74.  
  75.      Drawings created with the MUSICAL PAINT BRUSH can be
  76. saved to disk and later retrieved for further editing or
  77. display. There is also an accompanying program, SHOW.EXE,
  78. that may be used to display any of the drawings created with
  79. the MUSICAL PAINT BRUSH. Instructions for using  SHOW.EXE
  80. appear later in this documentation.
  81.  
  82.  
  83.  
  84.  
  85.                         INSTALLATION
  86.         This program has been distributed in PKZIP format. You will 
  87. need to use your copy of PKUNZIP to unpack all of the supplied programs.
  88. I suggest creating a directory on your hard disk called MPB, and 
  89. unpacking the files into that directory. To do this type:
  90.  
  91.                         CD\ <enter>
  92.  
  93. to change to the root directory.
  94.  
  95.                         MD MPB <enter>
  96.  
  97. to create the directory called MPB
  98.  
  99.                         CD\MPB
  100.  
  101. to change to the MPB directory
  102.  
  103.                         PKUNZIP source_drive\MPB10.zip C:\MPB
  104.  
  105. to unpack the files into the MPB directory.
  106.  
  107.  
  108.  
  109.  
  110.                         HOW TO DO IT
  111.  
  112.      Before starting the program be sure that you have
  113. loaded your mouse driver. A Microsoft or any compatible
  114. mouse will do fine, but be sure that you are using a version
  115. of the mouse driver that supports VGA graphics.
  116.  
  117.      All of the files included in this package should be
  118. present in the same directory, whether on a floppy or hard
  119. disk. Start the program by typing PAINT <ENTER>. If your
  120. mouse driver has not been loaded the  program will display
  121. an error message and return to DOS. If the program finds
  122. your mouse driver it will successfully start and present to
  123. you the main editing screen.
  124.  
  125. Present on this screen you will find:
  126.           The drawing tools represented as icons along the left edge
  127.           The color selection bar located just below the icons
  128.           The current color/background displayed just below the color 
  129.                  selection bar
  130.           The main menu bar located across the top of the screen
  131.           The sound buttons located beneath the main menu bar
  132.           The editing area comprising the remaining portion of the 
  133.                  screen and initially shown in black.
  134.  
  135. Each of these items will be discussed in detail in the following sections.
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.                  The Main Menu Bar
  143.  
  144. The main menu bar contains the following sub-menus:
  145.      Main
  146.      Patterns
  147.      Edit
  148.      Songs
  149.  
  150. The Main Menu
  151.      Selections available under the Main sub menu and their
  152. functions are:
  153.           NEW - clears the screen and resets it to all black.
  154.           SOUND ON/OFF - turns the available sounds on or off, 
  155.                 depending on their current state.
  156.           SAVE - displays an input field prompting for the name of 
  157.                 the file you wish to save.
  158.           LOAD - displays an input field prompting for the 
  159.                 name of the file you wish to load.
  160.           QUIT - exits the MUSICAL PAINT BRUSH
  161.  
  162. The Pattern Menu
  163.      Selections under the Pattern sub-menu include:
  164.           EMPTY
  165.           SOLID
  166.           LT SLASH
  167.           SLASH
  168.           BACKSLASH 1
  169.           BACKSLASH 2
  170.           HATCH
  171.           MESH
  172.           WIDE DOT
  173.           CLOSE DOT
  174.      Each of these options sets the current fill pattern to
  175. it's appropriate description.
  176.  
  177. The Edit Menu
  178.      Only one option exists under the edit menu:
  179.           UNDO - restores the picture to it's most recent state
  180.  
  181. The Song Menu
  182.      Selections under the song sub menu include:
  183.           TWINKLE - Twinkle Twinkle Little Star
  184.           MARY - Mary Had A Little Lamb
  185.           JESUS - Jesus Loves Me
  186.           ABC - The ABC Song
  187.           FARMER - The Farmer In The Dell
  188.           TURTLES - Teenage Mutant Ninja Turtle Theme
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                       The Drawing Tools
  195.                               
  196.      The drawing tools are represented by icons in the upper
  197. left area of the main screen. The following describes the
  198. function of each of the drawing tools.
  199.  
  200.      The PAINT tool - Use this tool to fill in a complete
  201.         shape. Set the foreground color to the color
  202.         of the border to fill to. Set the background color to the
  203.         desired fill color. Use the PATTERN menu to select a fill 
  204.         pattern. Click the left mouse button within the area to be           
  205.         filled and it will fill to the border. Be sure that there 
  206.         are no leaks in the border before filling or the fill color 
  207.         will leak out into the remainder of the screen. If this occurs 
  208.         use the EDIT UNDO menu option to restore the screen to its 
  209.         previous state.
  210.  
  211.      The SPRAY tool - Use this tool to simulate paint coming
  212.         from a spray can. The spray color will be the
  213.         currently selected foreground color. Press the left mouse
  214.         key to begin spraying and hold it down until
  215.         the desired area is sprayed.
  216.  
  217.      The LINE tool - Use this tool to draw straight lines in
  218.         any direction. The line color will be the currently selected 
  219.         foreground color. Press the left mouse button at the desired 
  220.         starting point. Keep the left mouse button depressed and drag 
  221.         the line to the desired ending point. Release the left mouse 
  222.         button to complete the line.
  223.  
  224.      The FREEHAND tool - Use this tool to draw freehand lines. The 
  225.         line color will be the currently selected foreground color. 
  226.         Press the left mouse button to begin drawing. Hold the left            
  227.         mouse button down and move the mouse in the desired direction(s). 
  228.         Release the left mouse button to complete the line.
  229.  
  230.      The ELLIPSE tool - Use this tool to create ellipses. The border 
  231.         color will be the currently selected foreground color. Press 
  232.         the left mouse button at the desired CENTER POINT for the 
  233.         ellipse. Hold down the left mouse button and drag the mouse 
  234.         to the desired dimensions of the ellipse. Release the left 
  235.         mouse button to complete the ellipse.
  236.  
  237.      The FILLED ELLIPSE tool - This tool functions the same as the 
  238.         ELLIPSE tool, however, the completed ellipse will be filled 
  239.         with the currently select background color and pattern.
  240.  
  241.      The RECTANGLE tool - Use this tool to create rectangles. The 
  242.         border color will be the currently selected foreground color. 
  243.         Press the left mouse button at the desired corner location. 
  244.         Keep the left mouse button pressed and drag the mouse to the 
  245.         desired rectangle dimensions. Release the left mouse button to
  246.         complete the rectangle.
  247.  
  248.      The FILLED RECTANGLE tool - This tool functions the same as the 
  249.         RECTANGLE tool, however, the completed rectangle will be 
  250.         filled with the currently selected background color and pattern.
  251.  
  252.      The ERASE tool - Use this tool to erase previously drawn shapes, 
  253.         or to draw a pattern onto the screen. The erase color will be 
  254.         the currently selected background color and pattern. Press 
  255.         and hold the left mouse button while guiding the mouse over the
  256.         desired area.
  257.  
  258.      The MOVE tool - Use this tool to move a previously drawn image on 
  259.         the screen. Press the left mouse button at the upper left corner 
  260.         of the image to be moved. Keep the left mouse button depressed 
  261.         while dragging the mouse downward and to the right until the 
  262.         desired image is bounded by the rectangle on screen. Release 
  263.         the left mouse button. Press the left mouse button again to 
  264.         "grab" the lower right corner of the image. Keeping the left 
  265.         mouse key depressed, move the image to the desired location. 
  266.         Release the left mouse button. You can continue the moving 
  267.         process repeatedly. The shape will remain marked for moving until 
  268.         you press the right mouse key. Pressing the right mouse key ends 
  269.         the current moving process. Note that the current background
  270.         color and fill pattern will be used to fill in the area from 
  271.         which the image was moved.
  272.  
  273.  
  274.  
  275.  
  276.  
  277.                        COLOR SELECTION
  278.                               
  279. Color selection is done as follows:
  280.  
  281.      To select the current foreground color click the LEFT mouse button 
  282.         on the desired color from the color bar.
  283.      To select the current background color click the RIGHT mouse button 
  284.         on the desired color from the color bar.
  285.  
  286.  
  287.  
  288.                        PLAYING SOUNDS
  289.                               
  290.      To play any of the many sound effects simply click with
  291. the left mouse button on the desired sound button.  Each
  292. button produces its own unique sound. The sound is disabled
  293. if the MAIN SOUND OFF menu selection has been made.
  294.  
  295.      The first button in the row is special. It does not
  296. play a sound, but rather stops any currently playing sound
  297. or song immediately. It does not turn off the sound,
  298. however, as the MAIN SOUND OFF menu selection does.
  299.  
  300.      Note that drawing can continue while any of the sounds or songs
  301. are playing in the background.
  302.  
  303.  
  304.  
  305.                           SHOW.EXE
  306.                               
  307.      There is a file provided with the MUSICAL PAINT BRUSH
  308. that can be used for displaying your creations without
  309. loading the MUSICAL PAINT BRUSH program. To do this from the
  310. DOS prompt type SHOW <filename> <ENTER> where filename is
  311. the name of the file you wish to display. The image will
  312. remain displayed until you press any key. Control will then
  313. return to DOS.
  314.  
  315.  
  316.  
  317.                            SUMMARY
  318.  
  319.      That's all there is to it. Why don't you load the
  320. program now and begin enjoying creating magical works of art
  321. with the MUSICAL PAINT BRUSH. Please forward any problems or
  322. comments on the program to me along with your registration
  323. fee. I'll do everything I can to ensure a quality, well
  324. appreciated program. Thank you.
  325.  
  326.                               Dave Reinhart
  327.